9.2Modbus命令管理

功能意义：命令下发会指定某台Modbus设备，并对此设备的指定属性进行异步读写。

9.2.1通过deviceId向挂载到网关的Modbus设备下发异步命令

功能描述：异步向挂载到网关的Modbus设备下发命令，读取/写入功能点属性信息。

POST /api/v1/commands/gateway/modbus/async

Body:

Body example:

{
    "deviceId":10086,
    "functionType": "propertySet",
    "identifier": "身高",
    "identifierValue": "180"
}
当功能属性类型为Bytes时，identifierValue由多个16进制字符和空格组成，空格无实际意义，例如:
"identifierValue": "13 0F 03"

cURL example:

curl --location --request POST '{URI-scheme}://{Endpoint}{path-prefix}/api/v1/commands/gateway/modbus/async?accessKeyId={accessKeyId}&signatureNonce=495&signature={signature}' \
--header 'platform: 3' \
--header 'projectId: {projectId}' \
--header 'Content-Type: application/json' \
--data-raw '{
                "deviceId":10086,
                "functionType": "propertySet",
                "identifier": "身高",
                "identifierValue": "180"
            }'

Response data:

Response example:

{
    "code":0,
    "message":null,
    "data":{
        "commandId": "02e86b96-a484-4e4e-9282-84b804f68fd5"
    }
}

9.2.2通过productId + deviceName向挂载到网关的Modbus设备下发异步命令

功能描述：异步向挂载到网关的Modbus设备下发命令，读取/写入功能点属性信息。

POST /api/v1/command/gateway/async/byname

Body:

Body example:

{
    "productId":10086,
    "deviceName": "test",
    "functionType": "propertySet",
    "identifier": "身高",
    "identifierValue": "180"
}
当功能属性类型为Bytes时，identifierValue由多个16进制字符和空格组成，空格无实际意义，例如:
"identifierValue": "13 0F 03"

cURL example:

curl --location --request POST '{URI-scheme}://{Endpoint}{path-prefix}/api/v1/command/gateway/async/byname?accessKeyId={accessKeyId}&signatureNonce=495&signature={signature}' \
--header 'platform: 3' \
--header 'projectId: {projectId}' \
--header 'Content-Type: application/json' \
--data-raw '{
                "productId":10086,
                "deviceName": "test",
                "functionType": "propertySet",
                "identifier": "身高",
                "identifierValue": "180"
            }'

Response data:

Response example:

{
    "code":0,
    "message":null,
    "data":{
        "commandId": "02e86b96-a484-4e4e-9282-84b804f68fd5"
    }
}